home *** CD-ROM | disk | FTP | other *** search
/ Mac-Source 1994 July / Mac-Source_July_1994.iso / Pascal / Utilities / Snippets / README About MPW InForm < prev    next >
Encoding:
Text File  |  1991-08-10  |  3.2 KB  |  95 lines  |  [TEXT/MPS ]
  1. #
  2. #    File:        About MPW InForm
  3. #
  4. #    Contains:    xxx put contents here xxx
  5. #
  6. #    Written by:    G. Sawitzki, StatLab Heidelberg
  7. #
  8. #    Copyright:    © 1991 by G. Sawitzki, Heidelberg, all rights reserved.
  9. #
  10. #    Change History (most recent first):
  11. #
  12. #         <4>     8/10/91    gs        add std mode
  13. #         <4>     8/10/91    gs        add std mode
  14. #         <3>      8/8/91    gs        add -f option
  15. #         <2>      8/5/91    gs        3.49 changes. -a and -f are changed
  16. #         <1>      8/2/91    gs        first checked in
  17. #
  18. #    To Do:
  19. #
  20.  
  21. This is InForm 3.49
  22.  InForm is an MPW tool that allows you to reformat Pascal 
  23.  source files, to build abstracts, and to build crossreference 
  24.  lists. 
  25.  It is quicker and smaller than the tools provided with MPW. 
  26.  And It is fail-safe in that it does not suppose that your 
  27.  program is syntactically correct (in contrast to Pasmat, 
  28.  Pasref etc. InForm even allows yout to reformat sources in 
  29.  place: it can operate on windows and even on selections.
  30.     
  31.  This version does not yet support markers.
  32.     
  33.  
  34. This will add a menu entry to call InForm on the active window:
  35.     
  36.         AddMenu edit 'InForm/I' 'InForm "{active}"'
  37.  
  38.     # Usage: inform [options] ([target window] | [-from file] [-to file]
  39.  
  40. Here is the MPW.Help-info for InForm
  41.     
  42.         InForm [option…] [window] > abstract/crossref ≥ messages
  43.         -a    <style>                #    write abstract to default output
  44.                                 #   valid abstract styles are STD, IM and 411
  45.         -caps                    #    put reserved words to capslock
  46.         -ccol column            #    align trailing comments to column    / to come… 
  47.         -cross                    #    write crossreferences to default output
  48.         -from sourcefile        #    read source from file. selections are ignored 
  49.         -f    <style>                #    define formatting style
  50.                                 #   valid abstract styles are STD
  51.         -p                        #    write progress information to diagnostic
  52.         -to targetfile             #    write formated source to file.
  53.         -w    width                #    set output line width (default 128)    / to come…
  54.     -
  55.     This is the info line to add to the commands list in mpw.help:
  56.     
  57.         InForm            # format and analyze pascal programs
  58.         
  59. Inform is  n o t in the public domain. It is copyrighted, with all rights
  60. reserved.
  61. The recent version, with full options and documentatin, is available at $29 for
  62. disk and handling from 
  63.         G. Sawitzki, Römerstr. 38, D 6900 Heidelberg, W. Germany.
  64.  
  65. Please send bug reports, comments etc to
  66.     gs@statlab.uni-heidelberg.de   on Internet
  67. or
  68.     GER.XUU0003                    on AppleLink
  69.     
  70. To see some possibilities of inform, use the following lines, and inspect the
  71. resulting windows:
  72.  
  73. (
  74. set mytest xxxxx.p ### <-----  replace xxxxx.p by any of your pascal programs
  75. target "{mytest}"
  76. # example 1: formatting only
  77. inform -from "{mytest}" -to "{mytest}".informed && target "{mytest}".informed
  78. # example 2: abstract only
  79. inform -a IM -from "{mytest}" > "{mytest}".abstract && target "{mytest}".abstract
  80. # example 2.1: abstract only. Standard style
  81. inform -a STD -from "{mytest}" > "{mytest}".abstract && target "{mytest}".abstract.std
  82. # example 3: crossreference only
  83. inform -cross -from "{mytest}" > "{mytest}".cross  && target "{mytest}".cross
  84. ### Introduce some bogus bus affecting the control structure (e.g. delete some 'end') 
  85. ### and run the following line
  86. # example 4: diagnostics
  87. inform -p -from "{mytest}" -to "{mytest}".informed.bug ∂
  88.     ≥ "{mytest}".informed.bug.report ∂
  89.     && (target "{mytest}".informed.bug.report;target "{mytest}".informed.bug)
  90. stackwindows
  91. unset mytest
  92.  
  93. )
  94.  
  95.